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I. 


INTRODUCTION 


The ATARI (R) 800™ and ATARI 400™ Personal Computer Systems 
contain a 6502 microprocessor, 4 I/O chips, operating System ROM, expandable 
RAM, and several MSI chips for address decoding and data bus buffering. 

This manual is primarily intended to describe the 4 I/O chips in sufficent 
detail to allow experienced programmers to create assembly language programs, 
such as Video games. All four Input/Output chips are controlled by the 
microprocessor by writing directly into their registers which are decoded 
to exist in microprocessor memory space just as RAM does. These I/O chips 
can also be interrogated by the microprocessor by reading similar registers. 

Many registers are write only and cannot be read after they are 
written. In some cases, reading from the same address gives the value 
contained in a separate read only register. Some write only registers are 
strobes. No data bits are needed in this case since the presence of the 
address on the bus is what triggers the requested action. The usual 
Convention is to use the STA (Store Accumulator) Instruction for such 
registers. For example, STA WSYNC performs the wait for Sync function. 

STX (Store X) or STY (Store Y) would work just as well. In BASIC, a POKE 
could be used (the data could be anything). Reading a register is accomp- 
lished by using any of the load instructions (LDA, LDX etc.). In BASIC 
a PEEK would be used. When the hardware register names are defined in an 
equate list, the programmier can refer to the registers by name rather than 
using the addresses directly. 

It is really not necessary for the programmier to know which 
I/O functions are performed by which of the 4 chips, however it 
does help in learning these functions. 


This manual should be used in conjunction with the Operating 
System (OS) Manual, a 6502 programming manual, and the ATARI 400/800 
Basic Refere nce Manual . 


CHIP NAME FUNCTION 


ANTIC 


CTIA 


DMA(Direct Memory Access) control 
NMI(Non-Maskable Interrupt) control 
Vertical and Horizontal fine Scrolling 
Light pen position registers 
Vertical line counter 
WSYNC(wait for horizontal sync) 

Priority control (display of overlapping objects) 
Color-Lumimance control (colors and brightness assigned 
to all objects including DMA objects from ANTIC) 
PLAYER-MISSILE objects (4 players and 4 missiles) 
Graphics registers 
Size control 

Horizontal position control 
Collision detection between all objects 
Switches and triggers (miscellaneous 1/0 functions) 
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CHIP NAME 


FUNCTION 


POREY Keyboard scan and control 

Serial Communications port (bidirectional) 

Pot scan (digitizes position of 8 independent pots) 
Audio generation (4 Channels) 

Timers 

IRQ (maskable interrupt) control from peripherals 
Random number generator 

PIA. Controller (Joystick) jacks read or write 

Peripheral control and interrupt lines 
IRQ (maskable) interrupt control from peripherals 


Section II describes the hardware in some detail, including the 
various graphics modes. Section III lists the hardware registers one at a 
time, describing what each bit is used for. It is organized by functional 
groups (Interrupts, graphics, audio, etc•)* Section IV contains a sample 
display program. Section V contains various figures and block diagrams of 
the System. Sections VI and VII list the hardware registers in address 
order and alphabetical order. Section VII includes hex and decimal 
addresses, the OS shadow registers and the page numbers where more infor- 
mation can be found. 
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II. DESCRIPTION OF HARDWARE 


A. ANTIC AND CXIA 

TV Display : The ANTIC and CTIA chips generate the television 
display at the rate of 60 frames per second on the NTSC (US) System. 

The PAL (European) System is different and is described in the section 
on NTSC vs PAL. Each frame consists of 262 horizontal TV Lines and each 
line is made up of 228 color clocks, as shown in figure VI-3. The 6502 
microprocessor runs at 1.79 MHz. This rate was chosen so that one 
machine cycle is equivalent in length to two color clocks. One clock 
is approximately equal in width to two TV lines. 

In any graphics mode, the display is divided up into small squares 
or rectangles called pixels (picture elements). The highest resolution 
graphics mode has a pixel size of 1/2 color clock by 1 TV line. A 
sample display list is given in section IV. 

The current TV line may be determined by reading the vertical counter 
(VCOUNT). This register gives the line count divided by 2. There are 262 
lines per frame so VCOUNT runs from 0 to 130 (0 to 155 on the PAL System). 
The 0 point occurs near the end of vertical blank (see figure VI.5). 
Vertical blank (VBLANK) is the time during which the electron beam returns 
back to the top of the screen in preparation for the next frame. The 
Atari 800 does not do interlacing, so each frame is identical unless 
the program which is being executed changes the display. Vertical sync 
(VSYNC) occurs during the fourth through sixth lines of vertical blank 
(VCOUNT = hex 7D through 7F). This teils the TV set where each frame 
Starts. After VSYNC, there are 16 more lines of VBLANK for a total of 22 
lines of VBLANK. The display list jump and wait instruction (to be 
described later) causes the display list graphics to Start at the end of 
VBLANK. 


Operating System (OS) : The ATARI 400/800 comes with a 10K Operating 
System (OS) in ROM. The OS affects some of the hardware registers, so 
it will be mentioned from time to time in this manual. Refer to the OS 
manual for more details. The OS descriptions in this manual apply to the 
Version that was being distributed when this manual was written. 

The OS Supports most of the hardware graphics modes (BASICS, GRAPHICS, 
PLOT, and DRAWTO coramands). The OS always displays 24 Background lines after 
the end of vertical blank. This convention is used at Atari to compensate 
for television sets which overscan. Most TV's are designed so that the 
edges of the picture are cut off. This is fine for ordinary broadcasts, 
but with a Computer it is essential for all important Information to be 
displayed on the screen. It is fairly common for four to eight color 
clocks at the right or left edge of the picture to overscan. A TV set 
that has excessive overscan may have to readjusted to obtain a satisfactory 
display. 
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The OS uses 192 TV llnes for its dlsplay and devotes the remaining 
24 Lines to overscan. It uses the Standard dlsplay width of 160 color 
clocks. The hardware will allow displays of any length, but it is recom- 
mended that the Standards be followed. The exception might be a border 
or other Information which is merely decorative and not essential to use 
of the program. 


OS Shadowlng : Since many of the hardware registers are write-only 
and cannot be read the OS has a number of "shadow registers" in RAM. 

Every TV frame during vertical blank the OS takes the values in some of 
its shadow registers, and writes them out to the corresponding hardware 
register. The OS does attract color shifting on all of the color registers 
if ATRACT (on OS register) is negative. This is to prevent damage to the 
TV screen phosphors which can occur if the brightness is turned up too high 
and the same high-luminance dlsplay is left on for a long time. The OS also 
reads the Joysticks and other Controllers during vertical blank and Stores 
the results in shadow registers, so that user programs do not have to include 
code to unpack the data. There are a few interrupt-related registers which 
the OS changes or reads during interrupt Processing. Programs usually access 
the OS shadow registers instead of accessing the hardware directly. However, 
the OS shadowlng can be disabled by changing the vertical blank and interrupt 
vectors (see OS manual). 


WSYNC : In addition to a Vertical Blank Interrupt, which allows the 

Microprocessor to synchronize to the vertical TV display, this System also 
provides a Walt for Horizontal Sync (WSYNC) command that allows the 
microprocessor to synchronize itself to the TV horizontal line rate. This 
sync takes effect when the processor writes to an I/O location called 
WSYNC, whenever it desires horizontal synchronization. Writing to this 
address sets a latch which pulls to zero a pin on the microprocessor 
called READY. When READY goes to zero the microprocessor stops and waits. 
The latch is automatically reset (returning READY true) at the beginning 
of the next horizontal blank interval, releasing the microprocessor to 
resume program execution. 


Object DMA (Direct Memory Access) : The primary function of the Antic 
chip is to fetch data from memory (independent of the microprocessor) for 
display on the TV screen. It does this with a technique called "Direct 
Memory Access" or DMA. It requests the use of the memory address and data 
bus by sending a Signal called HALT to the microprocessor, causing the 
processor to become "TRI-STATE" (open Circuit) all during the next Computer 
cycle. The ANTIC chip then takes over the address bus and reads any data 
it wishes from memory. Another name for this type of DMA is "cycle stealing". 
Once initiated, this DMA is completely and automatically controlled by the 
Antic chip without need for futher microprocessor Intervention. 

There are two types of DMA: Playfield and Player-Missile (see Figure 
II.2). The playfield DMA control Circuit on the Antic chip resembles a 
small dumb microprocessor. By halting the main microprocessor it can 
fetch its own instructions from memory (the display list) addressed by Its 
program counter(display list pointer). Each instruction defines the type 
(alpha character or memory map), and the resolution (size of bits on the 
screen), and the location of the data in memory which is to be displayed 
on the next group of iines. 
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In Order to begin this DMA the main microprocessor must störe a 
display list of instructions in memory, störe data to be displayed in 
memory, teil the ANTIC where the display list is (initialize the display 
list pointer) and enable the DMA control flags on the ANTIC (DMACTL 
register). 

In addition to the playfield DMA described above, the ANTIC 
chip simultaneously Controls another DMA channel. This type of DMA 
addresses PLAYER-MISSILE graphics data stored in memory and passes the 
graphics data on to the CTIA Chip graphics registers. This type of DMA 
(if enabled) occurs automatically, interspersed with the playfield DMA 
described previously. This PLAYER-MISSILE DMA has no display list or 
instructions, and is therefore much simpler than the PLAYFIELD DMA. 

In addition to the two types of display DMA, the ANTIC Chip also 
generates DMA addresses for the refresh of the dynamic memory RAM used 
in this System. This is also completely automatic and need be consider- 
ed by the programmer only if he is concerned with real-time programming 
where an exact count of the Computer cycles is important. 


Color-luminance : A color-luminance register is used on the CTIA chip 
for each Player-Missile and Playfield type. Each color-lum register is 
loaded by the microprocessor with a code representing the desired color 
and luminance of its corresponding Player-Missile or Playfield type. As 
the serial data passes through the CTIA chip it is "impressed" with the 
color and luminance values contained in these registers, before being sent 
to the TV display. In areas of the screen where there are no objects the 
background color (COLBK) is displayed. The CTIA also does collision 
detection (to be described later). 


Priority : When raoving objects, such as players and missiles, 
overlap on the TV screen (with each other or with Playfield) a decision 
must be made as to which object shows in front of the other. Objects 
which appear to pass in front of others are said to have Priority over 
them. Priority is assigned to all objects by the CTIA chip before the 
serial data from each object is combined with the other objects and sent 
to the TV screen. 

The priority of objects can be controlled by the microprocessor by 
writing into the control register PRIOR. The functions of the bits in 
this register are given in the table in the PRIOR register description in 
section III. 


Players and Missiles : The players and missiles are small objects 
which can be moved quickly in the horizontal direction by changing their 
Position registers. They are called players and missiles because they 
were originally designed to be used in games for objects such as airplanes 
and bullets. However, there are many other possible applications for 
them. The four glayer-missile color registers, in conjunction with the 
four playfield color registers and the background color register, make 
it possible to display 9 different colors at the same time. 
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